package org.dromara.exam.service;

import org.dromara.common.mybatis.core.page.PageQuery;
import org.dromara.common.mybatis.core.page.TableDataInfo;
import org.dromara.exam.domain.bo.ExamRepoBo;
import org.dromara.exam.domain.dto.ProjectSetting;
import org.dromara.exam.domain.vo.ExamRepoVo;
import org.dromara.exam.domain.dto.TemplateSchema;
import org.dromara.exam.domain.vo.RepoInfoVo;
import org.springframework.core.io.Resource;
import org.springframework.http.ResponseEntity;

import java.util.Collection;
import java.util.List;

/**
 * 题库Service接口
 *
 * @author xiyin321
 * @date 2024-04-11
 */
public interface IExamRepoService {

    /**
     * 根据ID查询题库详情
     *
     * @param repoId 题库ID
     * @return 题库视图对象
     */
    ExamRepoVo queryById(Long repoId);

    /**
     * 分页查询题库列表
     *
     * @param bo         查询条件对象
     * @param pageQuery  分页参数
     * @return 分页数据结果
     */
    TableDataInfo<ExamRepoVo> queryPageList(ExamRepoBo bo, PageQuery pageQuery);

    /**
     * 查询题库列表（非分页）
     *
     * @param bo 查询条件对象
     * @return 题库视图列表
     */
    List<ExamRepoVo> queryList(ExamRepoBo bo);

    /**
     * 新增题库
     *
     * @param bo 题库业务对象
     * @return 操作结果
     */
    Boolean insertByBo(ExamRepoBo bo);

    /**
     * 修改题库信息
     *
     * @param bo 题库业务对象
     * @return 操作结果
     */
    Boolean updateByBo(ExamRepoBo bo);

    /**
     * 批量删除题库
     *
     * @param ids     待删除ID集合
     * @param isValid 是否进行关联校验
     * @return 操作结果
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    /**
     * 下载题库导入模板
     *
     * @param templateName 模板名称（不含后缀）
     * @return 文件资源响应实体
     */
    ResponseEntity<Resource> downloadTemplate(String templateName);

    /**
     * 从题库中随机抽取试题
     *
     * @param conditions 随机抽题条件集合
     * @return 按顺序排列的项目结构列表
     */
    List<TemplateSchema> pickTemplateFromRepo(List<ProjectSetting.RandomQuestionCondition> conditions);

    /**
     * 查询题库列表（包含模板）
     *
     * @param bo 题库业务对象
     * @return 题库视图列表
     */
    List<RepoInfoVo> queryListAndTemplate(ExamRepoBo bo);
}
